home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmScale.z / XmScale
Text File  |  1998-10-30  |  73KB  |  1,057 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSccccaaaalllleeee - The Scale widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Scale.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           Scale is used by an application to indicate a value from
  19.           within a range of values, and it allows the user to input or
  20.           modify a value from the same range.
  21.  
  22.           A Scale has an elongated rectangular region similar to a
  23.           ScrollBar. A slider inside this region indicates the current
  24.           value along the Scale. The user can also modify the Scale's
  25.           value by moving the slider within the rectangular region of
  26.           the Scale. A Scale can also include a label set located
  27.           outside the Scale region.  These can indicate the relative
  28.           value at various positions along the scale.  The placement
  29.           of this label depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnnresource of
  30.           the widget.
  31.  
  32.           A Scale can be either input/output or output only. An
  33.           input/output Scale's value can be set by the application and
  34.           also modified by the user with the slider. An output-only
  35.           Scale is used strictly as an indicator of the current value
  36.           of something and cannot be modified interactively by the
  37.           user.  The XXXXmmmmSSSSccccaaaalllleeee resource XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee specifies whether
  38.           the user can interactively modify the Scale's value.
  39.  
  40.           The user can specify resources in a resource file for the
  41.           automatically created gadget that contains the title of the
  42.           Scale widget. The name of the gadget is TTTTiiiittttlllleeee.  The
  43.           placement of the title depends on the
  44.           XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnnresource of the widget. The direction of
  45.           the title is based on the widget's layout direction.
  46.  
  47.           Scale uses the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait, and holds the
  48.           _X_m_Q_T_t_r_a_n_s_f_e_r trait.
  49.  
  50.         DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
  51.           Scale supports dragging of the representation of the Scale
  52.           value from the Scale when the value is displayed and when
  53.           the value of the XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeeeDDDDrrrraaaagggg resource of
  54.           XXXXmmmmDDDDiiiissssppppllllaaaayyyy is set to True.
  55.  
  56.           As a source of data, Scale supports the following targets
  57.           and associated conversions of data to these targets:
  58.  
  59.           _C_O_M_P_O_U_N_D__T_E_X_T
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     The widget transfers a string representation of
  75.                     XXXXmmmmNNNNvvvvaaaalllluuuueeee as type _C_O_M_P_O_U_N_D__T_E_X_T.
  76.  
  77.           _S_T_R_I_N_G    The widget transfers a string representation of
  78.                     XXXXmmmmNNNNvvvvaaaalllluuuueeee as type _S_T_R_I_N_G.
  79.  
  80.           ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
  81.                     The widget transfers, as type _A_T_O_M, a list of the
  82.                     targets it supports for the _C_L_I_P_B_O_A_R_D selection.
  83.                     These include _S_T_R_I_N_G and _C_O_M_P_O_U_N_D__T_E_X_T.
  84.  
  85.           ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
  86.                     The widget transfers, as type _A_T_O_M, a list of the
  87.                     targets to be used as the value of the
  88.                     DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
  89.                     transfer.  These include _S_T_R_I_N_G and _C_O_M_P_O_U_N_D__T_E_X_T.
  90.  
  91.           As a source of data, Scale also supports the following
  92.           standard Motif targets:
  93.  
  94.           _B_A_C_K_G_R_O_U_N_D
  95.                     The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L.
  96.  
  97.           _C_L_A_S_S     The widget finds the first shell in the widget
  98.                     hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
  99.                     transfers the contents as text in the current
  100.                     locale.
  101.  
  102.           _C_L_I_E_N_T__W_I_N_D_O_W
  103.                     The widget finds the first shell in the widget
  104.                     hierarchy and transfers its window as type _W_I_N_D_O_W.
  105.  
  106.           _C_O_L_O_R_M_A_P  The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P.
  107.  
  108.           _F_O_R_E_G_R_O_U_N_D
  109.                     The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L.
  110.  
  111.           _N_A_M_E      The widget finds the first shell in the widget
  112.                     hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
  113.                     transfers the contents as text in the current
  114.                     locale.
  115.  
  116.           _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
  117.                     targets it supports.  These include the standard
  118.                     targets in this list.  These also include _S_T_R_I_N_G
  119.                     and _C_O_M_P_O_U_N_D__T_E_X_T.
  120.  
  121.           _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
  122.                     the selection as type _I_N_T_E_G_E_R.
  123.  
  124.           ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
  125.                     The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     or else the default text render table, as type
  141.                     _S_T_R_I_N_G.
  142.  
  143.           ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY
  144.                     The widget transfers its encoding registry as type
  145.                     _S_T_R_I_N_G.  The value is a list of NULL separated
  146.                     items in the form of tag encoding pairs.  This
  147.                     target symbolizes the transfer target for the
  148.                     Motif Segment Encoding Registry.  Widgets and
  149.                     applications can use this Registry to register
  150.                     text encoding formats for specified render table
  151.                     tags.  Applications access this Registry by
  152.                     calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
  153.                     XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.
  154.  
  155.         DDDDeeeesssscccceeeennnnddddaaaannnnttttssss
  156.           Scale automatically creates the descendants shown in the
  157.           following table.  An application can use XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt to
  158.           gain access to the named descendant. In addition, a user or
  159.           an application can use the named descendant when specifying
  160.           resource values.
  161.           NNNNaaaammmmeeeedddd DDDDeeeesssscccceeeennnnddddaaaannnntttt   CCCCllllaaaassssssss           IIIIddddeeeennnnttttiiiittttyyyy
  162.           __________________________________________________________________________________________________
  163.           SSSSccccrrrroooollllllllbbbbaaaarrrr          XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr     scroll bar
  164.           TTTTiiiittttlllleeee              XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt   title of scale
  165.  
  166.         CCCCllllaaaasssssssseeeessss
  167.           Scale inherits behavior, resources, and traits from CCCCoooorrrreeee,
  168.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrrclasses.
  169.  
  170.           The class pointer is _x_m_S_c_a_l_e_W_i_d_g_e_t_C_l_a_s_s.
  171.  
  172.           The class name is XXXXmmmmSSSSccccaaaalllleeee.
  173.  
  174.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  175.           The following table defines a set of widget resources used
  176.           by the programmer to specify data. The programmer can also
  177.           set the resource values for the inherited classes to set
  178.           attributes for this widget. To reference a resource by name
  179.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  180.           prefix and use the remaining letters. To specify one of the
  181.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  182.           the XXXXmmmm prefix and use the remaining letters (in either
  183.           lowercase or uppercase, but include any underscores between
  184.           words).  The codes in the access column indicate if the
  185.           given resource can be set at creation time (C), set by using
  186.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  187.           not applicable (N/A).
  188.  
  189.                                            XXXXmmmmSSSSccccaaaalllleeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  203.  
  204.  
  205.  
  206.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                    TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt      AAAAcccccccceeeessssssss
  207.           XmNconvertCallback        XmCCallback              XtCallbackList   NULL         C
  208.           XmNdecimalPoints          XmCDecimalPoints         short            0            CSG
  209.           XmNdragCallback           XmCCallback              XtCallbackList   NULL         C
  210.           XmNeditable               XmCEditable              Boolean          True         CSG
  211.           XmNfontList               XmCFontList              XmFontList       dynamic      CSG
  212.           XmNhighlightOnEnter       XmCHighlightOnEnter      Boolean          False        CSG
  213.           XmNhighlightThickness     XmCHighlightThickness    Dimension        2            CSG
  214.           XmNmaximum                XmCMaximum               int              100          CSG
  215.           XmNminimum                XmCMinimum               int              0            CSG
  216.           XmNorientation            XmCOrientation           unsigned char    XmVERTICAL   CSG
  217.           XmNprocessingDirection    XmCProcessingDirection   unsigned char    dynamic      CSG
  218.           XmNscaleHeight            XmCScaleHeight           Dimension        0            CSG
  219.           XmNscaleMultiple          XmCScaleMultiple         int              dynamic      CSG
  220.           XmNscaleWidth             XmCScaleWidth            Dimension        0            CSG
  221.           XmNrenderTable            XmCRenderTable           XmRenderTable    dynamic      CSG
  222.           XmNshowArrows             XmCShowArrows            XtEnum           XmNONE       CSG
  223.           XmNshowValue              XmCShowValue             XtEnum           XmNONE       CSG
  224.           XmNsliderMark             XmCSliderMark            XtEnum           dynamic      CSG
  225.           XmNsliderVisual           XmCSliderVisual          XtEnum           dynamic      CSG
  226.           XmNslidingMode            XmCSlidingMode           XtEnum           XmSLIDER     CSG
  227.           XmNtitleString            XmCTitleString           XmString         NULL         CSG
  228.           XmNvalue                  XmCValue                 int              dynamic      CSG
  229.           XmNvalueChangedCallback   XmCCallback              XtCallbackList   NULL         C
  230.  
  231.           XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
  232.                     Specifies a list of callbacks called when the
  233.                     Scale is asked to convert a selection.  The type
  234.                     of the structure whose address is passed to these
  235.                     callbacks is XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason
  236.                     is XXXXmmmmCCCCRRRR____OOOOKKKK.
  237.  
  238.           XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss
  239.                     Specifies the number of decimal points to shift
  240.                     the slider value when displaying it. For example,
  241.                     a slider value of 2,350 and an
  242.                     XXXXmmmmddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssssvalue of 2 results in a display
  243.                     value of 23.50.  The value must not be negative.
  244.  
  245.           XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk
  246.                     Specifies the list of callbacks that is called
  247.                     when the slider position changes as the slider is
  248.                     being dragged. The reason sent by the callback is
  249.                     XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG.
  250.  
  251.           XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
  252.                     Specifies how the Scale scrollbar will react to
  253.                     user input. This resource can be True or False
  254.                     values, as follows:
  255.  
  256.                     TTTTrrrruuuueeee      Allows the scrollbar to be sensitive to
  257.                               user input. This is the default value.
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     FFFFaaaallllsssseeee     Makes the Scale scrollbar insensitive to
  273.                               user input. The visual is not greyed
  274.                               out. This value would mostly be used in
  275.                               XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRRmode.
  276.  
  277.                     When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the
  278.                     dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE.
  279.  
  280.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  281.                     Specifies the font list to use for the title text
  282.                     string specified by XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg, and the label
  283.                     displayed when XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeeeis True. The font list
  284.                     is an obsolete structure, and is retained only for
  285.                     compatibility with earlier releases of Motif. See
  286.                     the XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee resource.
  287.  
  288.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr
  289.                     Specifies whether the highlighting rectangle is
  290.                     drawn when the cursor moves into the widget.  If
  291.                     the shell's focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, this
  292.                     resource is ignored, and the widget is highlighted
  293.                     when it has the focus.  If the shell's focus
  294.                     policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is True,
  295.                     the highlighting rectangle is drawn when the the
  296.                     cursor moves into the widget.  If the shell's
  297.                     focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is
  298.                     False, the highlighting rectangle is not drawn
  299.                     when the the cursor moves into the widget.  The
  300.                     default is False.
  301.  
  302.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssss
  303.                     Specifies the size of the slider's border drawing
  304.                     rectangle used for enter window and traversal
  305.                     highlight drawing.
  306.  
  307.           XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  308.                     Specifies the slider's maximum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  309.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  310.  
  311.           XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm
  312.                     Specifies the slider's minimum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  313.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  314.  
  315.           XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn
  316.                     Displays Scale vertically or horizontally.  This
  317.                     resource can have values of XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL and
  318.                     XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL.
  319.  
  320.           XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  321.                     Specifies whether the value for XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm is on
  322.                     the right or left side of XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for
  323.                     horizontal Scales or above or below XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for
  324.  
  325.  
  326.  
  327.      Page 5                                         (printed 10/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                     vertical Scales.  This resource can have values of
  339.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, and
  340.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT.  If the Scale is oriented
  341.                     vertically, the default value is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP.  If
  342.                     the XmScale is oriented horizontally, the default
  343.                     value depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource
  344.                     of the widget.
  345.  
  346.           XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
  347.                     Specifies the render table to use for the title
  348.                     text string specified by XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg, and the
  349.                     label displayed when XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee is True. If this
  350.                     value is NULL at initialization, the parent
  351.                     hierarchy is searched for an ancestor that holds
  352.                     the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait. If such an
  353.                     ancestor is found, the render table is initialized
  354.                     to the XXXXmmmmLLLLAAAABBBBEEEELLLL____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor
  355.                     widget. If no such ancestor is found, the default
  356.                     is implementation dependent. If a font list
  357.                     (XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt) and a render table are both
  358.                     specified, the render table will take precedence.
  359.                     Refer to XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on
  360.                     the creation and structure of a render table.
  361.  
  362.           XXXXmmmmNNNNssssccccaaaalllleeeeHHHHeeeeiiiigggghhhhtttt
  363.                     Specifies the height of the slider area.  The
  364.                     value should be in the specified unit type (the
  365.                     default is pixels).  If no value is specified a
  366.                     default height is computed.
  367.  
  368.           XXXXmmmmNNNNssssccccaaaalllleeeeMMMMuuuullllttttiiiipppplllleeee
  369.                     Specifies the amount to move the slider when the
  370.                     user takes an action that moves the slider by a
  371.                     multiple increment.  The default is (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm -
  372.                     XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) divided by 10, with a minimum of 1.
  373.  
  374.           XXXXmmmmNNNNssssccccaaaalllleeeeWWWWiiiiddddtttthhhh
  375.                     Specifies the width of the slider area.  The value
  376.                     should be in the specified unit type (the default
  377.                     is pixels).  If no value is specified a default
  378.                     width is computed.
  379.  
  380.           XXXXmmmmNNNNsssshhhhoooowwwwAAAArrrrrrrroooowwwwssss
  381.                     Specifies whether the arrows are displayed and how
  382.                     they are to be displayed. This resource can take
  383.                     the following values:
  384.  
  385.                     XXXXmmmmEEEEAAAACCCCHHHH____SSSSIIIIDDDDEEEE
  386.                               Indicates that one arrow is displayed on
  387.                               each end of the ScrollBar slider.
  388.  
  389.                     XXXXmmmmMMMMAAAAXXXX____SSSSIIIIDDDDEEEE
  390.  
  391.  
  392.  
  393.      Page 6                                         (printed 10/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                               Indicates that one arrow is displayed on
  405.                               the XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm side of the ScrollBar
  406.                               slider.
  407.  
  408.                     XXXXmmmmMMMMIIIINNNN____SSSSIIIIDDDDEEEE
  409.                               Indicates that one arrow is displayed on
  410.                               the XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm side of the ScrollBar
  411.                               slider.
  412.  
  413.                     XXXXmmmmNNNNOOOONNNNEEEE    Indicates that no arrows are displayed.
  414.  
  415.                     XXXXmmmmNNNNOOOONNNNEEEE is the default value.
  416.  
  417.           XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee
  418.                     Specifies whether a label for the current slider
  419.                     value should be displayed next to the slider. If
  420.                     the value is XXXXmmmmNNNNEEEEAAAARRRR____SSSSLLLLIIIIDDDDEEEERRRR, the current slider
  421.                     value is displayed. If the value is XXXXmmmmNNNNOOOONNNNEEEE, no
  422.                     slider value is displayed.  If the value is
  423.                     XXXXmmmmNNNNEEEEAAAARRRR____BBBBOOOORRRRDDDDEEEERRRR, the current slider value is
  424.                     displayed near the border.
  425.  
  426.           XXXXmmmmNNNNsssslllliiiiddddeeeerrrrMMMMaaaarrrrkkkk
  427.                     Specifies the shape the slider is to be displayed
  428.                     in. This resource can take the following values:
  429.  
  430.                     XXXXmmmmEEEETTTTCCCCHHHHEEEEDDDD____LLLLIIIINNNNEEEE
  431.                               Specifies the slider as an etched line.
  432.                               This is the default when XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee
  433.                               is XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR.
  434.  
  435.                     XXXXmmmmNNNNOOOONNNNEEEE    Specifies the slider as a foregrounded
  436.                               rectangle. This is the default when
  437.                               XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee is XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR and the
  438.                               Scale scrollbar is insensitive to user
  439.                               input (XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is FFFFaaaallllsssseeee.
  440.  
  441.                     XXXXmmmmRRRROOOOUUUUNNNNDDDD____MMMMAAAARRRRKKKK
  442.                               Specifies the slider as a shadowed
  443.                               circle. This is the default when
  444.                               XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee is XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR and the
  445.                               Scale scrollbar is sensitive to user
  446.                               input (XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is TTTTrrrruuuueeee.
  447.  
  448.                     XXXXmmmmTTTTHHHHUUUUMMMMBBBB____MMMMAAAARRRRKKKK
  449.                               Specifies the slider as a series of
  450.                               three etched lines centered in the
  451.                               middle of the slider.
  452.  
  453.           XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee
  454.                     Specifies the mode the slider works in. There are
  455.                     two possible modes:
  456.  
  457.  
  458.  
  459.      Page 7                                         (printed 10/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                     XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR  Allows the slider to move freely between
  471.                               the minimum and maximum ends of the
  472.                               scale. This is the default value.
  473.  
  474.                     XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR
  475.                               Forces the slider to be anchored to one
  476.                               side of the trough area.
  477.  
  478.           XXXXmmmmNNNNsssslllliiiiddddeeeerrrrVVVViiiissssuuuuaaaallll
  479.                     Specifies the color of the slider visual.  This
  480.                     resource can take the following values:
  481.  
  482.                     XXXXmmmmBBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR
  483.                               Specifies that the slider visual is in
  484.                               the background color.
  485.  
  486.                     XXXXmmmmFFFFOOOORRRREEEEGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR
  487.                               Specifies that the slider visual is in
  488.                               the foreground color.
  489.  
  490.                     XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWWEEEEDDDD____BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD
  491.                               Specifies that the slider visual is in
  492.                               the background color, with a shadow.
  493.                               This is the default when the
  494.                               _X_m_N_s_l_i_d_i_n_g_M_o_d_e_l resource is XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR.
  495.  
  496.                     XXXXmmmmTTTTRRRROOOOUUUUGGGGHHHH____CCCCOOOOLLLLOOOORRRR
  497.                               Specifies that the slider visual is in
  498.                               the trough color. This is the default
  499.                               when the _X_m_N_s_l_i_d_i_n_g_M_o_d_e_l resource is
  500.                               XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR.
  501.  
  502.           XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg
  503.                     Specifies the title text string to appear in the
  504.                     Scale widget window.
  505.  
  506.           XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the slider's current position along the
  507.                     scale, between XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm and XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm.  The
  508.                     value is constrained to be within these inclusive
  509.                     bounds.  The initial value of this resource is the
  510.                     larger of 0 (zero) and XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  511.  
  512.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  513.                     Specifies the list of callbacks that is called
  514.                     when the value of the slider has changed. The
  515.                     reason sent by the callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.
  516.  
  517.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  518.           Scale inherits behavior and resources from the superclasses
  519.           described in the following tables.  For a complete
  520.           description of each resource, refer to the reference page
  521.           for that superclass.
  522.  
  523.  
  524.  
  525.      Page 8                                         (printed 10/24/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                                                 XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  537.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  538.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel               dynamic                CSG
  539.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  540.           XmNforeground             XmCForeground           Pixel               dynamic                CSG
  541.           XmNhelpCallback           XmCCallback             XtCallbackList      NULL                   C
  542.           XmNhighlightColor         XmCHighlightColor       Pixel               dynamic                CSG
  543.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap              dynamic                CSG
  544.           XmNinitialFocus           XmCInitialFocus         Widget              NULL                   CSG
  545.           XmNlayoutDirection        XmCLayoutDirection      XmDirection         dynamic                CG
  546.           XmNnavigationType         XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  547.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList      NULL                   C
  548.           XmNshadowThickness        XmCShadowThickness      Dimension           2                      CSG
  549.           XmNstringDirection        XmCStringDirection      XmStringDirection   dynamic                CG
  550.           XmNtopShadowColor         XmCTopShadowColor       Pixel               dynamic                CSG
  551.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap              dynamic                CSG
  552.           XmNtraversalOn            XmCTraversalOn          Boolean             True                   CSG
  553.           XmNunitType               XmCUnitType             unsigned char       dynamic                CSG
  554.           XmNuserData               XmCUserData             XtPointer           NULL                   CSG
  555.  
  556.                                   CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  557.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  558.           XmNchildren         XmCReadOnly         WidgetList    NULL      G
  559.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  560.           XmNnumChildren      XmCReadOnly         Cardinal      0         G
  561.  
  562.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  563.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  564.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  565.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  566.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  567.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  568.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  569.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  570.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  571.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  572.           XmNdepth                        XmCDepth                        int              dynamic                CG
  573.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  574.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  575.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  576.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  577.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  578.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  579.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  580.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  581.           XmNx                            XmCPosition                     Position         0                      CSG
  582.           XmNy                            XmCPosition                     Position         0                      CSG
  583.  
  584.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  585.           A pointer to the following structure is passed to the
  586.           XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures:
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                         (printed 10/24/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  599.  
  600.  
  601.  
  602.           typedef struct
  603.           {
  604.                   int _r_e_a_s_o_n;
  605.                   XEvent * _e_v_e_n_t;
  606.                   int _v_a_l_u_e;
  607.           } XmScaleCallbackStruct;
  608.  
  609.           _r_e_a_s_o_n    Indicates why the callback was invoked
  610.  
  611.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback
  612.  
  613.           _v_a_l_u_e     Is the new slider value
  614.  
  615.           A pointer to the following structure is passed to the
  616.           XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures:
  617.  
  618.           typedef struct
  619.           {
  620.                   int _r_e_a_s_o_n;
  621.                   XEvent *_e_v_e_n_t;
  622.                   Atom _s_e_l_e_c_t_i_o_n;
  623.                   Atom _t_a_r_g_e_t;
  624.                   XtPointer _s_o_u_r_c_e__d_a_t_a;
  625.                   XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
  626.                   int _f_l_a_g_s;
  627.                   XtPointer _p_a_r_m;
  628.                   int _p_a_r_m__f_o_r_m_a_t;
  629.                   unsigned long _p_a_r_m__l_e_n_g_t_h;
  630.                   int _s_t_a_t_u_s;
  631.                   XtPointer _v_a_l_u_e;
  632.                   Atom _t_y_p_e;
  633.                   int _f_o_r_m_a_t;
  634.                   unsigned long _l_e_n_g_t_h;
  635.           } XmConvertCallbackStruct;
  636.  
  637.           _r_e_a_s_o_n    Indicates why the callback was invoked.
  638.  
  639.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  640.                     It can be NULL.
  641.  
  642.           _s_e_l_e_c_t_i_o_n Indicates the selection for which conversion is
  643.                     being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
  644.                     _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.
  645.  
  646.           _t_a_r_g_e_t    Indicates the conversion target.
  647.  
  648.           _s_o_u_r_c_e__d_a_t_a
  649.                     Contains information about the selection source.
  650.                     When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, _s_o_u_r_c_e__d_a_t_a is
  651.                     the DragContext.  Otherwise, it is NULL.
  652.  
  653.           llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
  654.  
  655.  
  656.  
  657.      Page 10                                        (printed 10/24/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     Contains information about the location of data to
  669.                     be converted.  If the value is NULL, the data to
  670.                     be transferred consists of the widget's current
  671.                     selection.
  672.  
  673.           _f_l_a_g_s     Indicates the status of the conversion. Following
  674.                     are the possible values:
  675.  
  676.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
  677.                               This flag is currently unused.
  678.  
  679.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____PPPPAAAARRRRTTTTIIIIAAAALLLL
  680.                               The target widget was able to be
  681.                               converted, but some data was lost.
  682.  
  683.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
  684.                               The conversion target is the source of
  685.                               the data to be transferred.
  686.  
  687.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____TTTTRRRRAAAANNNNSSSSAAAACCCCTTTT
  688.                               This flag is currently unused.
  689.  
  690.           _p_a_r_m      Contains parameter data for this target.  If no
  691.                     parameter data exists, the value is NULL.
  692.  
  693.                     When _s_e_l_e_c_t_i_o_n is _C_L_I_P_B_O_A_R_D and _t_a_r_g_e_t is
  694.                     ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS or
  695.                     ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS, the value is
  696.                     the requested operation (XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmMMMMOOOOVVVVEEEE, or
  697.                     XXXXmmmmLLLLIIIINNNNKKKK).
  698.  
  699.           _p_a_r_m__f_o_r_m_a_t
  700.                     Specifies whether the data in _p_a_r_m should be
  701.                     viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g
  702.                     quantities.  Possible values are 0 (when _p_a_r_m is
  703.                     NULL), 8 (when the data in _p_a_r_m should be viewed
  704.                     as a list of _c_h_a_rs), 16 (when the data in _p_a_r_m
  705.                     should be viewed as a list of _s_h_o_r_ts), or 32 (when
  706.                     the data in _p_a_r_m should be viewed as a list of
  707.                     _l_o_n_gs).  Note that _p_a_r_m__f_o_r_m_a_t symbolizes a data
  708.                     type, not the number of bits in each list element.
  709.                     For example, on some machines, a _p_a_r_m__f_o_r_m_a_t of 32
  710.                     means that the data in _p_a_r_m should be viewed as a
  711.                     list of 64-bit quantities, not 32-bit quantities.
  712.  
  713.           _p_a_r_m__l_e_n_g_t_h
  714.                     Specifies the number of elements of data in _p_a_r_m,
  715.                     where each element has the size specified by
  716.                     _p_a_r_m__f_o_r_m_a_t.  When _p_a_r_m is NULL, the value is 0.
  717.  
  718.           _s_t_a_t_u_s    An IN/OUT member that specifies the status of the
  719.                     conversion.  The initial value is
  720.  
  721.  
  722.  
  723.      Page 11                                        (printed 10/24/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  731.  
  732.  
  733.  
  734.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT.  The callback procedure can set
  735.                     this member to one of the following values:
  736.  
  737.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT
  738.                               This value means that the widget class
  739.                               conversion procedure, if any, is called
  740.                               after the callback procedures return.
  741.                               If the widget class conversion procedure
  742.                               produces any data, it overwrites the
  743.                               data provided by the callback procedures
  744.                               in the _v_a_l_u_emember.
  745.  
  746.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE
  747.                               This value means that the widget class
  748.                               conversion procedure, if any, is called
  749.                               after the callback procedures return.
  750.                               If the widget class conversion procedure
  751.                               produces any data, it appends its data
  752.                               to the data provided by the callback
  753.                               procedures in the _v_a_l_u_e member.  This
  754.                               value is intended for use with targets
  755.                               that result in lists of data, such as
  756.                               _T_A_R_G_E_T_S.
  757.  
  758.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE
  759.                               This value means that the callback
  760.                               procedure has successfully finished the
  761.                               conversion.  The widget class conversion
  762.                               procedure, if any, is not called after
  763.                               the callback procedures return.
  764.  
  765.                     XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE
  766.                               This value means that the callback
  767.                               procedure has terminated the conversion
  768.                               process without completing the requested
  769.                               conversion.  The widget class conversion
  770.                               procedure, if any, is not called after
  771.                               the callback procedures return.
  772.  
  773.           _v_a_l_u_e     An IN/OUT parameter that contains any data that
  774.                     the callback procedure produces as a result of the
  775.                     conversion.  The initial value is NULL.  If the
  776.                     callback procedure sets this member, it must
  777.                     ensure that the _t_y_p_e, _f_o_r_m_a_t, and _l_e_n_g_t_h members
  778.                     correspond to the data in _v_a_l_u_e.  The callback
  779.                     procedure is responsible for allocating, but not
  780.                     for freeing, memory when it sets this member.
  781.  
  782.           _t_y_p_e      An IN/OUT parameter that indicates the type of the
  783.                     data in the _v_a_l_u_e member.  The initial value is
  784.                     _I_N_T_E_G_E_R.
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                        (printed 10/24/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  797.  
  798.  
  799.  
  800.           _f_o_r_m_a_t    An IN/OUT parameter that specifies whether the
  801.                     data in _v_a_l_u_e should be viewed as a list of _c_h_a_r,
  802.                     _s_h_o_r_t, or _l_o_n_g quantities.  The initial value is
  803.                     8.  The callback procedure can set this member to
  804.                     8 (for a list of _c_h_a_r), 16 (for a list of _s_h_o_r_t),
  805.                     or 32 (for a list of _l_o_n_g).
  806.  
  807.           _l_e_n_g_t_h    An IN/OUT member that specifies the number of
  808.                     elements of data in _v_a_l_u_e, where each element has
  809.                     the size symbolized by _f_o_r_m_a_t.  The initial value
  810.                     is 0.
  811.  
  812.         BBBBeeeehhhhaaaavvvviiiioooorrrr
  813.           XmScale has the following behavior:
  814.  
  815.           <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>> or <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  816.                     IIIInnnn tttthhhheeee rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn eeeennnndddd ooooffff tttthhhheeee SSSSccccaaaalllleeee aaaannnndddd tttthhhheeee
  817.                     sssslllliiiiddddeeeerrrr:  Moves the slider by one multiple
  818.                     increment in the direction of the end of the Scale
  819.                     and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  820.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or
  821.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  822.                     bottom increments the Scale value, and movement
  823.                     toward the left or top decrements the Scale value.
  824.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  825.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  826.                     decrements the Scale value, and movement toward
  827.                     the left or top increments the Scale value.  If
  828.                     the button is held down longer than a delay
  829.                     period, the slider is moved again by the same
  830.                     increment and the same callbacks are called.
  831.  
  832.                     IIIInnnn sssslllliiiiddddeeeerrrr::::Activates the interactive dragging of
  833.                     the slider.
  834.  
  835.           <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>> in value label:
  836.                     Drags the contents of the label showing the
  837.                     current slider value.  This action sets the
  838.                     XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc of the DragContext to a function
  839.                     that calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
  840.                     possibly multiple times, for the ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP
  841.                     selection.
  842.  
  843.           <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>> or <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
  844.                     If the button press occurs within the slider, the
  845.                     subsequent motion events move the slider to the
  846.                     position of the pointer and call the callbacks for
  847.                     XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk.
  848.  
  849.           <<<<BBBBttttnnnn1111UUUUpppp>>>> or <<<<BBBBttttnnnn2222UUUUpppp>>>>:
  850.                     If the button press occurs within the slider and
  851.                     the slider position is changed, the callbacks for
  852.  
  853.  
  854.  
  855.      Page 13                                        (printed 10/24/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk are called.
  867.  
  868.           <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  869.                     IIIInnnn tttthhhheeee rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn eeeennnndddd ooooffff tttthhhheeee SSSSccccaaaalllleeee aaaannnndddd tttthhhheeee
  870.                     sssslllliiiiddddeeeerrrr:  Moves the slider to that end of the Scale
  871.                     and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  872.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or
  873.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  874.                     bottom increments the Scale value, and movement
  875.                     toward the left or top decrements the Scale value.
  876.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  877.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  878.                     decrements the Scale value, and movement toward
  879.                     the left or top increments the Scale value.
  880.  
  881.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  882.                     For vertical Scales, moves the slider up one
  883.                     increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  884.                     callbacks.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  885.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the top increments
  886.                     the Scale value.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  887.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the top
  888.                     decrements the Scale value.
  889.  
  890.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  891.                     For vertical Scales, moves the slider down one
  892.                     increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  893.                     callbacks.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  894.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the bottom
  895.                     increments the Scale value.  If
  896.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement
  897.                     toward the bottom decrements the Scale value.
  898.  
  899.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  900.                     For horizontal Scales, moves the slider one
  901.                     increment to the left and calls the
  902.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  903.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  904.                     toward the left increments the Scale value.  If
  905.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  906.                     toward the left decrements the Scale value.
  907.  
  908.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  909.                     For horizontal Scales, moves the slider one
  910.                     increment to the right and calls the
  911.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  912.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  913.                     toward the right increments the Scale value.  If
  914.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  915.                     toward the right decrements the Scale value.
  916.  
  917.           <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
  918.  
  919.  
  920.  
  921.      Page 14                                        (printed 10/24/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  929.  
  930.  
  931.  
  932.                     For vertical Scales, moves the slider up one
  933.                     multiple increment and calls the
  934.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  935.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement
  936.                     toward the top increments the Scale value.  If
  937.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,
  938.                     movement toward the top decrements the Scale
  939.                     value.
  940.  
  941.           <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
  942.                     For vertical Scales, moves the slider down one
  943.                     multiple increment and calls the
  944.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  945.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,
  946.                     movement toward the bottom increments the Scale
  947.                     value.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,
  948.                     movement toward the bottom decrements the Scale
  949.                     value.
  950.  
  951.           <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
  952.                     For horizontal Scales, moves the slider one
  953.                     multiple increment to the left and calls the
  954.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  955.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  956.                     toward the left increments the Scale value.  If
  957.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  958.                     toward the left decrements the Scale value.
  959.  
  960.           <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
  961.                     For horizontal Scales, moves the slider one
  962.                     multiple increment to the right and calls the
  963.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  964.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  965.                     toward the right increments the Scale value.  If
  966.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  967.                     toward the right decrements the Scale value.
  968.  
  969.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>>:
  970.                     Moves the slider to the minimum value and calls
  971.                     the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  972.  
  973.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>>:
  974.                     Moves the slider to the maximum value and calls
  975.                     the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  976.  
  977.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffNNNNeeeexxxxttttFFFFiiiieeeelllldddd>>>>:
  978.                     Traverses to the first item in the next tab group.
  979.                     If the current tab group is the last entry in the
  980.                     tab group list, it wraps to the beginning of the
  981.                     tab group list.
  982.  
  983.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrreeeevvvvFFFFiiiieeeelllldddd>>>>:
  984.  
  985.  
  986.  
  987.      Page 15                                        (printed 10/24/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  995.  
  996.  
  997.  
  998.                     Traverses to the first item in the previous tab
  999.                     group.  If the beginning of the tab group list is
  1000.                     reached, it wraps to the end of the tab group
  1001.                     list.
  1002.  
  1003.           <<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
  1004.                     Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  1005.                     exist.  If there are no help callbacks for this
  1006.                     widget, this action calls the help callbacks for
  1007.                     the nearest ancestor that has them.
  1008.  
  1009.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  1010.           The bindings for virtual keys are vendor specific.  For
  1011.           information about bindings for virtual buttons and keys, see
  1012.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  1013.  
  1014.      RRRREEEELLLLAAAATTTTEEEEDDDD
  1015.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccaaaalllleeee(3),
  1016.           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), XXXXmmmmSSSSccccaaaalllleeeeGGGGeeeettttVVVVaaaalllluuuueeee(3), and XXXXmmmmSSSSccccaaaalllleeeeSSSSeeeettttVVVVaaaalllluuuueeee(3).
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                        (printed 10/24/98)
  1054.  
  1055.  
  1056.  
  1057.